home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / netbsd / install.txt < prev    next >
Encoding:
Text File  |  1996-01-12  |  41.8 KB  |  1,139 lines

  1. INSTALLATION NOTES for NetBSD/atari 1.1
  2.  
  3.  
  4.  
  5. Be sure to read _ALL_ of this document before you try to install
  6. NetBSD/atari.
  7.  
  8.  
  9.  
  10. What is NetBSD?
  11. ---- -- ------
  12.  
  13. NetBSD is a Berkeley Networking Release 2 (Net/2) and 4.4BSD-Lite
  14. -derived Operating System.  It is a fully functional UN*X-like system
  15. which runs on many architectures and is being ported to more.  NetBSD, 
  16. as the name implies, is a creation of the members of the network community
  17. and without the net it's likely that this release wouldn't have come
  18. about.
  19.  
  20. NetBSD 1.1 is a evolutionary release which contains over a year of
  21. changes to the kernel, user-level utilities, and documentation.
  22.  
  23. Continuing the multi-platform tradition, NetBSD has added ports to
  24. atari and mvme68k based machines.  Kernel interfaces have continued to
  25. be refined, and now several subsystems and device drivers are shared
  26. among the different ports.  You can look for this trend to continue.
  27.  
  28. NetBSD 1.1 has significantly enhanced the binary emulation subsystem 
  29. (which includes iBCS2, Linux, OSF/1, SunOS, SVR4, Solaris and Ultrix
  30. compatibility) and several kernel subsystems have been generalized
  31. to support this more readily.  The binary emulation strategy is 
  32. aimed at making the emulation as accurate as possible.
  33.  
  34. NetBSD 1.1 is also the first release to see machine-independent disk
  35. striping.  The concatenated disk driver (ccd), which was previously
  36. supported only by the hp300 port, has been vastly improved.  Many
  37. bugs were fixed, and explicit references to device-dependent routines
  38. removed and replaced by calls to the generic "vnode operation"
  39. routines.  In addition, several features were added, including partition
  40. support, dynamic configuration and unconfiguration via a user space system
  41. utility program, and virtually unlimited number of component devices.
  42.  
  43. Many new user programs have been added in NetBSD 1.1, as well,
  44. bringing it closer to our goal of supplying a complete UN*X-like
  45. environment. 
  46.  
  47.  
  48. The Atari release stepped in in March 1995. This means the NetBSD1.1
  49. is the first official release of NetBSD/Atari.
  50.  
  51.  
  52.  
  53. The Future of NetBSD:
  54. --- ------ -- ------
  55.  
  56. The NetBSD Foundation was recently incorporated as a non-profit
  57. organization.  It's purpose is to encourage, foster and promote the
  58. free exchange of computer software, namely the NetBSD Operating
  59. System.  The foundation will allow for many things to be handled more
  60. smoothly than could be done with our previous informal organization.
  61. In particular, it provides the framework to deal with other parties
  62. that wish to become involved in the NetBSD Project. (IN WHAT WAY?  Money, donations, etc)
  63.  
  64. We believe that the NetBSD Foundation will help improve the quality 
  65. of NetBSD by:
  66.  
  67.     * providing better organization to keep track of development
  68.       efforts, including co-ordination with groups working in 
  69.       related fields.
  70.  
  71.     * providing a framework to receive donations of goods and
  72.           services and to own the resources necessary to run the
  73.           NetBSD Project.
  74.  
  75.         * providing a better position from which to undertake
  76.           promotional activities.
  77.  
  78.         * periodically organizing workshops for developers and other
  79.           interested people to discuss ongoing work.
  80.  
  81. We hope to have regular releases of the full binary and source trees,
  82. but these are difficult to coordinate, especially with all of the
  83. architectures which we now support!  We hope to support even _more_
  84. hardware in the future, and have a rather large number of other ideas
  85. about what can be done to improve NetBSD.  We intend to continue our
  86. current practice of making the NetBSD-current development source
  87. available on a daily or nearly-daily basis.
  88.  
  89. We intend to integrate free, positive changes from whatever sources
  90. will provide them, providing that they are well thought-out and
  91. increase the usability of the system.
  92.  
  93. Above all, we hope to create a stable and accessible system, and to be
  94. responsive to the needs and desires of NetBSD users, because it is for
  95. and because of them that NetBSD exists.
  96.  
  97.  
  98. Sources of NetBSD:
  99. ------- -- ------
  100.  
  101. Host name        Services Provided
  102. ---- ----        -------- --------
  103. ftp.iastate.edu        Anonymous FTP, AFS
  104.  
  105.     Anon-FTP path: pub/netbsd
  106.     AFS path: /afs/iastate.edu/public/ftp/pub/netbsd
  107.  
  108. ftp.eecs.umich.edu    Anonymous FTP
  109.  
  110.     Anon-FTP path: BSD/NetBSD
  111.  
  112. gatekeeper.dec.com    Anonymous FTP
  113.  
  114.     Anon-FTP path: pub/BSD/NetBSD
  115.  
  116. wipux2.wifo.uni-mannheim.de    Anonymous FTP, SUP
  117.  
  118.     Anon-FTP path: pub/NetBSD
  119.     SUP: get the file pub/misc/sup/supfile.example via
  120.         anonymous FTP and read it as an example.
  121.  
  122. ftp.demon.co.uk        Anonymous FTP, possibly SUP
  123.  
  124.     Anon-FTP path: pub/BSD/NetBSD
  125.     SUP: contact peter@demon.net for SUP server status/information
  126.  
  127. ftp.uni-regensburg.de    Anonymous FTP
  128.  
  129.     Anon-FTP path: pub/NetBSD
  130.  
  131. ftp.unit.no        Anonymous FTP
  132.  
  133.     Anon-FTP path: pub/NetBSD
  134.  
  135. ftp.stacken.kth.se    Anonymous FTP
  136.  
  137.     Anon-FTP path: pub/OS/NetBSD
  138.  
  139. flick.lerc.nasa.gov    Anonymous FTP
  140.  
  141.     Anon-FTP path: pub/NetBSD
  142.  
  143. coombs.anu.edu.au    Anonymous FTP
  144.  
  145.     Anon-FTP path: pub/NetBSD
  146.  
  147. ftp.funet.fi        Anonymous FTP
  148.  
  149.     Anon-FTP path: pub/unix/NetBSD
  150.  
  151. ftp.netbsd.org        Anonymous FTP, SUP
  152.  
  153.     Anon-FTP path: pub/NetBSD
  154.     SUP: get the file pub/sup/README.sup via anonymous FTP from
  155.         ftp.netbsd.org, and read it for instructions.
  156.  
  157. If you wish to become a distribution site for NetBSD, contact
  158. mirrors@netbsd.org.
  159.  
  160.  
  161. NetBSD 1.1 Release Contents:
  162. ------ --- ------- --------
  163.  
  164. The NetBSD 1.1 release is organized in the following way:
  165.  
  166. .../NetBSD-1.1/
  167.         BUGS            Known bugs list (incomplete
  168.                     and out of date).
  169.  
  170.         CHANGES            Changes since NetBSD's last
  171.                     release (and before).
  172.  
  173.         LAST_MINUTE        Last minute changes.
  174.  
  175.         MIRRORS            A list of sites that mirror
  176.                     the NetBSD 1.1 distribution.
  177.  
  178.         README.files        README describing the
  179.                     distribution's contents.
  180.  
  181.         TODO            NetBSD's todo list (incomplete
  182.                     and out of date).
  183.  
  184.         patches/        Post-release source code
  185.                     patches.
  186.  
  187.         source/            Source distribution sets; see
  188.                     below.
  189.  
  190. In addition to the files and directories listed above, there is one
  191. directory per architecture, for each of the architectures that NetBSD
  192. 1.1 has a binary distribution for.  There are also
  193. 'README.export-control' files sprinkled liberally throughout the
  194. distribution tree, which point out that there are some portions of the
  195. distribution (e.g. those containing crypt(3)) that should not be
  196. exported from the United States, and that if you do export them, it's
  197. your fault, not ours.
  198.  
  199. The source distribution sets can be found in subdirectories of the
  200. "source" subdirectory of the distribution tree.  They contain the 
  201. complete sources to the system.  The source distribution sets 
  202. are as follows:
  203.  
  204.     dsrc11    This set contains the "domestic" sources.  These
  205.         sources contain export-restricted encryption code
  206.         and should not be exported from the U.S.
  207.         [ 140K gzipped, 655K uncompressed ]
  208.  
  209.     gsrc11    This set contains the "gnu" sources, including
  210.         the source for the compiler, assembler, groff,
  211.         and the other GNU utilities in the binary distribution
  212.         sets.
  213.         [ 7.1M gzipped, 30.4M uncompressed ]
  214.  
  215.     ksrc11    This set contains the sources to the NetBSD 1.1
  216.         kernel, config(8), config.old(8) and dbsym(8).
  217.         [ 6.0M gzipped, 27.0M uncompressed ]
  218.  
  219.     ssrc11    This set contains the "share" sources, which include
  220.         the sources for the man pages not associated with
  221.         any particular program, the sources for the
  222.         typesettable document set, the dictionaries, and more.
  223.         [ 2.4M gzipped, 8.9M uncompressed ]
  224.  
  225.     src11    This set contains all of the NetBSD 1.1 sources which
  226.         are not mentioned above.
  227.         [ 9.3M gzipped, 41.6M uncompressed ]
  228.  
  229. It is worth noting that unless all of the source distribution sets
  230. are installed (except the domestic set), you can't rebuild and install
  231. the system from scratch, straight out of the box.  However, all that is
  232. required to rebuild the system in that case is a trivial modification 
  233. to one Makefile.
  234.  
  235. The source distribution sets are distributed as groups of files named
  236. "set_name.xx" where "set_name" is the distribution set name, and "xx"
  237. is the sequence number of the file, starting with "aa" for the first
  238. file in the distribution set, then "ab" for the next, and so on.  All
  239. of these files except the last one of each set should be exactly
  240. 240,640 bytes long.  (The last file is just long enough to contain the
  241. remainder of the data for that distribution set.)
  242.  
  243. Catted together, the files belonging to a source distribution set 
  244. comprise a gzipped tar file.  If you want to look at list of the files
  245. contained in the set, you could use the command:
  246.  
  247.     cat set_name.?? | gunzip | tar tvf -
  248.  
  249. or to actually extract the files contained in the set:
  250.  
  251.     cat set_name.?? | gunzip | tar xfp -
  252.  
  253. In each of the source distribution set directories, there is a file
  254. named "CKSUMS" which contains the checksums of the files in that
  255. directory, as generated by the cksum(1) utility.  You can use cksum to
  256. check the integrity of the archives, if you suspect that one of the
  257. files is corrupt and have access to a cksum binary.
  258.  
  259. The Atari-specific portion of the NetBSD 1.1 release is found in the
  260. "atari" subdirectory of the distribution.  That subdirectory is layed
  261. out as follows:
  262.  
  263. .../NetBSD-1.1/atari/
  264.             binary/        atari binary distribution sets;
  265.                     see below.
  266.  
  267.             floppies/    atari boot and installation
  268.                     floppies; see below.
  269.  
  270.             security/    atari security distribution;
  271.                     see below;
  272.  
  273.             utils.netbsd/
  274.             utils.tos/    Miscellaneous atari
  275.                     installation utilities; see
  276.                     installation section, below.
  277.  
  278. There are three atari floppy images to be found in the "atari/floppies"
  279. subdirectory of the NetBSD 1.1 distribution.  One of them is a
  280. bootable TOS kernel floppy and the other two are installation floppy's.
  281. They are described in more detail below.  There are gzipped versions
  282. of each available, for easier downloading.  (The gzipped version
  283. have the ".gz" extension added to their names.)
  284.  
  285. Bootable Kernel floppy:
  286.  
  287.     This TOS disk contains the loadbsd and chg_part programs
  288.     and the GENERIC kernel.  It is setup so that you can insert it
  289.     int your floppy drive, and start the programs from GEM.
  290.  
  291.     This floppy is named boot-11.fs
  292.  
  293. Installation floppy:
  294.  
  295.     This disk contains a BSD root file system setup to help
  296.     you install the rest of NetBSD.  This includes formatting
  297.     and mounting your root and /usr partitions and getting
  298.     ready to extract (and possibly first fetching) the distribution
  299.     sets.  There is enough on this file system to allow you to
  300.     make a slip connection, configure an ethernet, mount an NFS
  301.     file system or ftp.  You can also load distribution sets from
  302.     a SCSI tape or from one of your existing TOS partitions.
  303.  
  304.     This floppy's are named "inst-11.fs.1" and "inst-11.fs.2".
  305.  
  306. The NetBSD/atari binary distribution sets contain the binaries which
  307. comprise the NetBSD 1.1 release for the atari.  There are seven binary
  308. distribution sets, and the "security" distribution set.  The binary
  309. distribution sets can be found in subdirectories of the "atari/binary"
  310. subdirectory of the NetBSD 1.1 distribution tree, and are as follows:
  311.  
  312.     base11    The NetBSD/atari 1.1 base binary distribution.  You
  313.         MUST install this distribution set.  It contains the
  314.         base NetBSD utilities that are necessary for the
  315.         system to run and be minimally functional.  It
  316.         includes shared library support, and excludes
  317.         everything described below.
  318.         [ 7M gzipped, 19M uncompressed ]
  319.  
  320.     comp11    The NetBSD/atari Compiler tools.  All of the tools
  321.         relating to C, C++, and FORTRAN (yes, there are two!).
  322.         This set includes the system include files
  323.         (/usr/include), the linker, the compiler tool chain,
  324.         and the various system libraries (except the shared
  325.         libraries, which are included as part of the base
  326.         set).  This set also includes the manual pages for all
  327.         of the utilities it contains, as well as the system
  328.         call and library manual pages.
  329.         [ 4M gzipped, 12M uncompressed ]
  330.  
  331.     etc11    This distribution set contains the system
  332.         configuration files that reside in /etc and in several
  333.         other places.  This set MUST be installed if you are
  334.         installing the system from scratch, but should NOT be
  335.         used if you are upgrading.  (If you are upgrading,
  336.         it's recommended that you get a copy of this set and
  337.         CAREFULLY upgrade your configuration files by hand.)
  338.         [ 50K gzipped, 280K uncompressed ]
  339.  
  340.     games11    This set includes the games and their manual pages.
  341.         [ 1M gzipped, 3M uncompressed ]
  342.  
  343.     man11    This set includes all of the manual pages for the
  344.         binaries and other software contained in the base set.
  345.         Note that it does not include any of the manual pages
  346.         that are included in the other sets.
  347.         [ 730K gzipped, 3M uncompressed ]
  348.  
  349.     misc11    This set includes the system dictionaries (which are
  350.         rather large), the typesettable document set, and
  351.         man pages for other architectures which happen to be
  352.         installed from the source tree by default.
  353.         [ 2M gzipped, 6M uncompressed ]
  354.  
  355.     text11    This set includes NetBSD's text processing tools,
  356.         including groff, all related programs, and their
  357.         manual pages.
  358.         [ 784K gzipped, 3M uncompressed ]
  359.  
  360. The atari security distribution set is named "secr11" and can be found
  361. in the "atari/security" subdirectory of the NetBSD 1.1 distribution
  362. tree.  It contains crypt.c (the source file for the DES encryption
  363. algorithm) and the binaries which depend on it.  It can only be found
  364. on those sites which carry the complete NetBSD distribution and that
  365. can legally obtain it.  (Remember, because of United States law, this
  366. distribution set may not be exported to locations outside of the
  367. United States and Canada.)  [ 119K gzipped, 300K uncompressed ]
  368.  
  369. The atari binary distribution sets are distributed in the same form as
  370. the source distribution sets; catted together, the members of a set
  371. form a gzipped tar file.  Each atari binary distribution set also has
  372. its own "CKSUMS" file, just as the source distribution sets do.
  373.  
  374. The instructions given for extracting the source sets work equally
  375. well for the binary sets, but it is worth noting that if you use that
  376. method, the files are extracted "below" the current directory.  That
  377. is, if you want to extract the binaries "into" your system, i.e.
  378. replace the system binaries with them, you have to run the "tar xvfp"
  379. from /.  Also note that if you upgrade or install this way, those
  380. programs that you are using at the time will NOT be replaced.  If you
  381. follow the normal installation or upgrade procedures, this will be
  382. taken care of for you.
  383.  
  384.  
  385.  
  386. NetBSD System Requirements and Supported Devices:
  387. ------ ------ ------------ --- --------- -------
  388.  
  389. NetBSD/atari 1.1 runs on a TT030 and a Falcon. Currently an FPU is
  390. required, although this might change in the (near) future. The
  391. minimum amount of RAM required is 4Mb.
  392.  
  393. Here is a table of recommended HD partition sizes for a full install:
  394.     partition:    advise,    with X,    needed,    with X
  395.     root (/)    15M    15M    10M    10M
  396.     user (/usr)    65M    100M    45M     80M
  397.     swap        ----- 2M for every M ram -----
  398.     local (/local)    up to you
  399.  
  400. As you may note the recommended size of /usr is 20M greater than
  401. needed. This is to leave room for a kernel source and compile tree
  402. as you will probably want to compile your own kernel. (GENERIC is
  403. large and bulky to accommodate all people, BOOT is small and might
  404. not have all the features you want).
  405.  
  406. Supported devices include:
  407.     - The buildin SCSI host adapter
  408.         - Should support most SCSI-drives. The drives that are
  409.           currently tested are:
  410.             MAXTOR 7245S, MAXTOR 7080S, SEAGATE ST157N
  411.         - Should support most tape drives. The drives that are
  412.           currently tested are:
  413.             TANDBERG 3600
  414.         - Should support most CD-ROM drives.
  415.     - The buildin video controller
  416.     - The building (720Kb/1.44Mb) floppydrive
  417.     - The serial2/modem2 ports
  418.     - The Falcon FX memory expansion
  419.     - The atari mouse
  420.  
  421. If its not on this list, there is no support for it in this release.
  422.  
  423.  
  424.  
  425. Getting the NetBSD System on to Useful Media:
  426. ------- --- ------ ------ -- -- ------ -----
  427.  
  428. Installation is supported from several media types, including:
  429.     TOS HD partitions
  430.     Tape
  431.  
  432. No matter what you do, however, you'll need to have three disks handy,
  433. on which you will put the install and boot floppy images.
  434.  
  435. All the images are available from the directory "atari/floppies",
  436. under the root of the NetBSD tree at your favorite archive site.
  437.  
  438. If you are using NetBSD/atari to make the floppies, you should use
  439. the command dd(1) to write the raw floppy images (.fs files) to
  440. the disk. To write onto fd0 use:
  441.  
  442.     dd if=inst-10.fs.1 of=/dev/rfd0b bs=9b
  443.  
  444. If you are using TOS to make the floppies, grab the 'rawwrite' utility
  445. from the "atari/utils" directory and issue the command:
  446.     rawwrite boot-10.fs
  447.  
  448. This will create the boot-floppy on the floppy in drive a. The floppies
  449. should be pre-formatted on 720Kb for both the 'dd' and 'rawwrite' commands
  450. to work. Pre-formatting can be best done using the desktop format command.
  451. Some other utilities seem to be giving problems.
  452.  
  453. The steps necessary to prepare the distribution sets
  454. for installation depend on which method of installation
  455. you choose.  The various methods are explained below.
  456.  
  457. To prepare for installing via an GEMDOS partition:
  458.  
  459.     To install NetBSD from an GEMDOS partition, you need to
  460.     get the NetBSD distribution sets you wish to install
  461.     on your system on to an GEMDOS partition.  All of the
  462.     set_name.xx pieces can be placed in a single directory
  463.     instead of separate ones for each distribution set.  This
  464.     will also simplify the installation work later on.
  465.  
  466.     Note where you place the files you will need this later.
  467.  
  468.     Once you have done this, you can proceed to the next
  469.     step in the installation process, preparing your hard disk.
  470.  
  471. To prepare for installing via a tape:
  472.  
  473.     To install NetBSD from a tape, you need to somehow
  474.     get the NetBSD filesets you wish to install on
  475.     your system on to the appropriate kind of tape,
  476.     in tar format.
  477.  
  478.     If you're making the tape on a UN*X system, the easiest
  479.     way to do so is:
  480.  
  481.         tar cvf <tape_device> <files>
  482.  
  483.     where "<tape_device>" is the name of the tape device
  484.     that describes the tape drive you're using (possibly
  485.     something like /dev/nrst0, but we make no guarantees 8-).
  486.     If you can't figure it out, ask your system administrator.
  487.     "<files>" are the names of the "set_name.nnn" files
  488.     which you want to be placed on the tape.
  489.  
  490.     Once you have done this, you can proceed to the next
  491.     step in the installation process, preparing your hard disk.
  492.  
  493.  
  494.  
  495. Preparing your System for NetBSD Installation:
  496. --------- ---- ------ --- ------ ------------
  497.  
  498. Note you will be modifying your HD's if you mess something up here you
  499. could lose everything on all the drives that you mess with.  It is
  500. therefore advised that you:
  501.  
  502.     Write down your current configurations.  Do this
  503.     by writing down all partition info (especially their sizes).
  504.  
  505.     Back up the partitions you are keeping.
  506.  
  507. What you need to do is partition your drives; creating
  508. space for at least root, swap and /usr partitions and possibly at
  509. least one more for /local if you have the space.
  510.  
  511. The partitioning can be done in two ways, the first method heavily
  512. relies on the AHDI way of partitioning, the second method nearly
  513. ignores the AHDI partitioning and gives you far more flexibility.
  514. Currently, the second method can only be achieved from a working
  515. NetBSD/atari system.  How this should be done is described in
  516. "upgrading to NetBSD-labeling".
  517.  
  518. Using AHDI partitioning:
  519.     The paritioning can be done with the AHDI-disk that is
  520.     provided with your TT or Falcon. Note that the AHDI partioning
  521.     function erases all partions on your harddisk even if they are
  522.     not changed!
  523.     I know this is rather stupid, but don't say I didn't warn you.
  524.  
  525.     You will need the 'chg_part' program from the bootdisk to
  526.     prepare your harddisk a bit more. This program will change the
  527.     partition-id so NetBSD knows which partitions it can use. The
  528.     synopsis is:
  529.         chg_part <driveno> <partno> <new_id>
  530.  
  531.     The drive number corresponds with the drive's SCSI-id. The new
  532.     id can be selected from one of the following acronyms:
  533.         NBU - NetBSD User partition
  534.         NBR - NetBSD Root partition
  535.         NBS - NetBSD Swap partition
  536.     Because NetBSD cannot be bootloaded (yet) and thus must be
  537.     loaded through GEM, it is unwise to use drive 'C'
  538.     (drive 0/partition 1) as a NetBSD partition. When a partition-id
  539.     is changed, GEMDOS won't be able to recognize your drive, so be
  540.     warned that the drive labels are shifted afterwards. The chg_part
  541.     program still recognizes them, take this into account when
  542.     re-labeling partitions. Also note that the chg_part process is
  543.     reversible. So don't panic if you made a mistake. Just run
  544.     chg_part again with the same drive/partition arguments but
  545.     supplied the original partition id.
  546.  
  547. Upgrading to NetBSD-labeling:
  548.     First of all the new disk label functions are fully backwards
  549.     compatible with the current (old) behaviour, therefore you don't
  550.     have to rename partition identifiers if you don't want to. The only
  551.     limitation is that you won't be able to write a disklabel to your
  552.     harddisk ("Device not configured.").
  553.  
  554.     If you'ld like to have the flexibility of the NetBSD disk label,
  555.     the procedure is very simple: change the identifier of the AHDI
  556.     partition that contains your NetBSD root filesystem from NBR to NBD.
  557.     Boot NetBSD; run `disklabel -e sd?'; disklabel will start vi;
  558.     quit vi without changing anything; now the disklabel should be
  559.     written to the NBD partition. If at this point disklabel tells
  560.     you that one or more of your partitions extend past the end of
  561.     the unit, then you have an old version of disklabel. Get the
  562.  
  563.     If you like, you can now change the NBD partition id to RAW
  564.     (this would for example be necessary if the partition must be
  565.     shared with MiNT), but keep in mind that the partition id must
  566.     be either NBD or RAW, otherwise NetBSD won't be able to find the
  567.     disklabel. The NBS id (used for a swap partition) is no longer
  568.     needed, you can change it to whatever you like (or leave it as
  569.     is, if that's what you like :-) ). The same is true for the
  570.     NBU id's.
  571.  
  572.     WARNINGS:
  573.         - the NBD partition does not necessarily have to be the
  574.           partition that contains the NetBSD root filesystem, but
  575.           it *must* be a partition that contains a fast filesystem.
  576.           Do *not* try this with a partition that contains a gemdos,
  577.           minix or ext2 filesystem; if you do, you'll *loose* a
  578.           filesystem.
  579.         - Now that you have a real disklabel, you can modify it in
  580.           (almost) any way you want. However, if you make a mess of
  581.           the disk label, NetBSD may (or may not) make a mess of
  582.           your disk! No freedom without responsibility.
  583.           NetBSD will try to warn you for a possibly dangerous
  584.           partition table, but it's up to you to either take that
  585.           warning serious or ignore it (there may be good reasons
  586.           to ignore the warning, if you know what you're doing).
  587.  
  588.     So what do you do if you have a new disk, that will be exclusively
  589.     used by NetBSD? Very simple: don't let it get `infected' by the
  590.     AHDI `virus'. ,-) Just connect the disk to your TT/Falcon; boot
  591.     NetBSD; run `disklabel -e'; you'll see only one large partiton `d'
  592.     (there won't be any filesytem on it yet); you can create partitions
  593.     in any way you want, as you're no longer limited by an AHDI partition
  594.     table.
  595.  
  596.  
  597.  
  598. Installing the NetBSD System:
  599. ---------- --- ------ ------
  600.  
  601. Installing NetBSD is a relatively complex process, but, if you have
  602. this document in hand and are careful to read and remember the
  603. information which is presented to you by the install program, it
  604. shouldn't be too much trouble.
  605.  
  606. Before you begin, you must have already prepared your hard disk as
  607. detailed in the section on preparing your system for install.
  608.  
  609. The following is a walk-through of the steps necessary to get NetBSD
  610. installed on your hard disk.  If you wish to stop the installation,
  611. you may hit Control-C at any prompt, but if you do, you'll have to
  612. begin again from scratch.
  613.  
  614.     First you need to get yourself into NetBSD.  This can be
  615.     done in a couple ways, both of which currently require
  616.     GEMDOS.
  617.  
  618.     You can insert the GEMDOS kernel floppy and select
  619.     the loadbsd program. It will ask for parameters, 
  620.     supply: '-b netbsd'.  You can, of course, also run it
  621.     from the shell command-line in MiNT:
  622.  
  623.         loadbsd -b a:/netbsd
  624.  
  625.     You should see the screen clear and some information about
  626.     your system as the kernel configures the hardware.  Then
  627.     you will be prompted for a root device.  At this time remove
  628.     the GEMDOS kernel boot floppy from the drive if present and
  629.     insert the BSD install floppy 1.  Now type `rd0' to tell the
  630.     kernel to load the install filesystem into RAMdisk. While
  631.     While the kernel is loading, it will show a '.' for each
  632.     track loaded. After loading 80 tracks, it will ask you
  633.     to insert the next floppy. At this time, inser the BSD
  634.     install floppy 2 and hit any key. The kernel continous
  635.     loading another 40 tracks before it continues to boot.
  636.  
  637.     The system should continue to boot.  For now ignore WARNING:
  638.     messages about bad dates in clocks. Eventually you will be
  639.     be asked to enter the pathname of the shell, just hit
  640.     return.  After a short while you should see a welcome
  641.     message and a prompt, asking if you wish to proceed with the
  642.     installation.
  643.  
  644.     If you wish to proceed, enter "y" and then return.
  645.  
  646.     If you have configured your hard drive[s] correctly it
  647.     should find the drive and partition that you selected to
  648.     use as your root.
  649.  
  650.     YOU ARE NOW AT THE POINT OF NO RETURN.  If you confirm that
  651.     you want to install NetBSD, your hard drive will be modified,
  652.     and perhaps its contents scrambled at the whim of the install
  653.     program.
  654.  
  655.     If you are sure you want to proceed, enter "yes" at the
  656.     prompt.
  657.  
  658.     The install program will now make the root filesystem you
  659.     specified.  There should be only one error in this section
  660.     of the installation.  It will look like so:
  661.  
  662.         newfs: ioctl (WDINFO): Invalid argument
  663.         newfs: /dev/rsd0a: can't rewrite disk label
  664.  
  665.     If there are any others, restart from the the beginning of
  666.     the installation process.  This error is ok as the Atari
  667.     does not write disklabels currently.  You should expect
  668.     this error whenever using newfs.
  669.  
  670.     Next the install program will ask you which drive and
  671.     partition you wish to use as /usr.  First it will list the
  672.     available drives.  Choose one.  Next it will give you a
  673.     list of the partitions on that disk along with their sizes,
  674.     types, etc..  Choose the letter that corresponds to the
  675.     partition you wish to use for /usr.  To be able to make the
  676.     proper selection, you need to know, that NetBSD assigns a
  677.     special meaning to some of the partition letters:
  678.         'a' : root filesystem
  679.         'b' : swap partition
  680.         'c' : whole disk
  681.     You should choose a letter in the range 'd'-'p' for your
  682.     /usr filesystem.  If you are doing a full install this should
  683.     be a partition that is at least 45M-50M large.  If everything is
  684.     ok the install program will then format and mount your /usr.  If
  685.     not then it will ask again for a drive and partition.
  686.  
  687.     When this completes your root partition will be mounted on
  688.     /mnt and your /usr partition on /mnt/usr.  An fstab will
  689.     have been created and initialized to correctly mount these
  690.     two file systems.  This fstab will be in /mnt/etc.
  691.  
  692.     What you do from this point on depends on which media you're
  693.     using to install NetBSD.  Follow the appropriate instructions,
  694.     given below.
  695.  
  696.     To install from an GEMDOS partition:
  697.  
  698.         You first need to mount the GEMDOS partition
  699.         using the mount_msdos command.  If e.g. your GEMDOS
  700.         partition is the first partition on sd0 you could
  701.         type:
  702.             
  703.             mkdir /mnt/gemdos
  704.             mount_msdos /dev/sd0d /mnt/gemdos
  705.  
  706.         You can use `disklabel sd0' to find out what types
  707.         of partitions are on the disk `sd0'.
  708.  
  709.         Next goto the directory in which you stored the
  710.         distribution sets.  If e.g. you stored them in the
  711.         root directory of the partition:
  712.  
  713.             cd /mnt/gemdos
  714.  
  715.         When there, run "Set_tmp_dir" and choose the default
  716.         temporary directory, by hitting return at the
  717.         prompt.
  718.  
  719.         Run the "Extract" command, giving it as its sole
  720.         argument the name of the distribution set you wish
  721.         to extract.  For example, to extract the base
  722.         distribution, use the command:
  723.  
  724.             Extract base11
  725.  
  726.         and to extract the games distribution:
  727.  
  728.             Extract game11
  729.  
  730.         If the distribution sets are in different directories,
  731.         you will need to cd to each directory in turn, runing
  732.         "Set_tmp_dir" and the appropriate "Extract" command(s).
  733.  
  734.         Continue this process until you've finished installing
  735.         all of the sets which you desire to have on your
  736.         hard disk.  Once you have extracted all sets and
  737.         are at the "#" prompt again, proceed to the section
  738.         "Configuring Your System," below.
  739.  
  740.     To install from tape:
  741.  
  742.         The first thing you should do is pick a temporary
  743.         directory where the distribution files can be stored.
  744.         To do this, use the command "Set_tmp_dir" and enter
  745.         your choice.  The default is /mnt/usr/distrib.
  746.  
  747.         After you have picked a temporary directory,
  748.         you should issue the load command:
  749.  
  750.             Load_tape
  751.  
  752.         Next, you will be told to insert the media into
  753.         the appropriate drive, and hit return.  Continue
  754.         to follow instructions until you are returned to
  755.         the "#" prompt.
  756.  
  757.         Go to the directory which contains the first
  758.         distribution set you wish to install.  This is
  759.         either the directory you specified above, or possibly
  760.         a subdirectory of that directory.
  761.  
  762.         When there, run "Set_tmp_dir" again, and choose
  763.         the default temporary directory, by hitting
  764.         return at the prompt.
  765.  
  766.         Run the "Extract" command, giving it as its sole
  767.         argument the name of the distribution set you
  768.         wish to extract.  For example, to extract the base
  769.         distribution, use the command:
  770.  
  771.             Extract base11
  772.  
  773.         and to extract the games distribution:
  774.  
  775.             Extract game11
  776.  
  777.         After the extraction is complete, go to the location
  778.         of the next set you want to extract, "Set_tmp_dir"
  779.         again, and once again issue the appropriate
  780.         extract command.  Continue this process until
  781.         you've finished installing all of the sets which you
  782.         desire to have on your hard disk.
  783.  
  784.         After each set is finished, if you know that you
  785.         are running low on space you can remove the
  786.         distribution files for that set by saying:
  787.  
  788.             rm set_name.??
  789.  
  790.         For example, if you wish to remove the distribution
  791.         files for the game09 set, after the "Extract game09"
  792.         command has completed, issue the command:
  793.  
  794.             rm game11.??
  795.  
  796.         Once you have extracted all sets and are at the "#" prompt
  797.         again, proceed to the section "Configuring Your System,"
  798.         below.
  799.  
  800. Configuring Your System:
  801. ----------- ---- ------
  802.  
  803. Once you have finished extracting all of the distribution sets that
  804. you want on your hard drive and are back at the "#" prompt,
  805. you are ready to configure your system.
  806.  
  807. The configuration utility expects that you have installed the base
  808. system.  If you have not, you will not be able to run it successfully
  809. (nor will you have a functional system regardless of configuration).
  810.  
  811. To configure the newly installed operating system, run the
  812. command "Configure".
  813.  
  814. Configure will ask for the machine's hostname, domain name, and other
  815. network configuration information.
  816.  
  817. Once you have supplied `Configure' all that it requests, your machine
  818. will be configured well enough that when you reboot it it will
  819. almost be a completely functional NetBSD system.  Note you should
  820. ignore the errors from `chown' they will be corrected shortly.
  821.  
  822. Once you are done with `Configure', halt the system with the "halt"
  823. command (wait for "halted" to be displayed) and reboot.  Then again
  824. boot NetBSD this time with the command:
  825.  
  826.     loadbsd netbsd
  827.  
  828. You need to do your final tweeks now.  First mount your file systems
  829. like so:
  830.  
  831.     mount -av
  832.  
  833. Next you need to re-make your devices to get the ownership correct:
  834.  
  835.     cd /dev
  836.     ./MAKEDEV all
  837.  
  838. Your system is now complete but not completely configured; you
  839. should adjust the /etc/sendmail.cf file as necessary to suit your
  840. site and/or disable sendmail and other network related programs.
  841. These things can be found in /etc/netstart.  Use vi, if you installed
  842. the man pages you can type `man vi' or `man ed' for instructions
  843. on how to use these somewhat non-intuitive editors.
  844.  
  845. As mentioned at the end of the `Configure' run, you should copy the
  846. NetBSD kernel onto the root partition as "/netbsd". There is also
  847. another option to this. As NetBSD/Atari has to be booted from TOS,
  848. you could do the following:
  849.     Reserve a small GEMDOS partition of about 4Mb. This is
  850.     enough to put in a few kernels. Put the netbsd kernel
  851.     into this partition. Also, edit your /etc/fstab to always
  852.     mount this partition, say as /kernels. Now make a symlink
  853.     from /netbsd to /kernels/netbsd.
  854.     This sceme is particulary handy when you want to make your
  855.     own kernel. When compilation is finished, you just copy
  856.     your kernel to /kernels/netbsd and reboot. It's wise to
  857.     make sure there is _always_ a 'know to work' kernel image
  858.     present.
  859.  
  860. To get the proper timezone settings, link /etc/localtime to the
  861. appropriate file in /usr/share/zoneinfo. The link provided is to
  862. /usr/share/zoneinfo/US/Pacific.
  863.  
  864. Once you are done with the rest of configuration unmount your file
  865. systems and halt your system, then reboot:
  866.  
  867.     cd /
  868.     umount -av
  869.     halt
  870.     <reboot>
  871.  
  872. Finally you can now boot your system and it will be completely
  873. functional:
  874.  
  875.     loadbsd -a netbsd
  876.  
  877. When it boots off of the hard drive, you will have a complete
  878. NetBSD system!  CONGRATULATIONS! (You really deserve them!!!)
  879.  
  880.  
  881.  
  882. Upgrading a previously-installed NetBSD System:
  883. --------- - ---------- --------- ------ ------
  884.  
  885. Before updating, you probably would want to backup your original
  886. filesystems!
  887.  
  888. The update procedure will not overwrite or remove any files not present
  889. in the sets you install. If you've replaced programs present in the
  890. distribution, you have to replace them again after you did the update.
  891. The etc-set needs special caution. You generally don't want to install
  892. this one when upgrading. It is recommended that you get a copy of this
  893. set and _carefully_ upgrade your configuration files by hand.
  894. Before starting the actual procedure, make a note of the partitions your
  895. root- and usr-filesystems are on. You'll need to mount them by hand.
  896.  
  897. Ok, let's go. Insert the bootfloppy and follow the 'normal' installation
  898. procedure until it asks you if you wish to proceed with the installation.
  899. Now enter 'n' and hit return. You will be left at the shell prompt. Now
  900. mount your root and usr filesystems on /mnt. If your root-filesystem is
  901. on sd1a and your usr-filesystem on sd1d this would require the following
  902. actions:
  903.     mount_ffs /dev/sd1a /mnt
  904.     mount_ffs /dev/sd1d /mnt/usr
  905.  
  906. At this point, you can follow the section "Installing the NetBSD System"
  907. to install the sets. There is one difference: When Extract asks you 
  908.     "Are you installing a -current snapshot? [n]"
  909. answer 'y'.
  910.  
  911. Once you are done installing the upgrade sets, then reboot:
  912.     cd /
  913.     umount -av
  914.     halt
  915.     <reboot>
  916.  
  917. Now you can boot your upgraded system as usually, but take the
  918. new kernel! To finish up, you should rebuild your /dev-directory:
  919.     cd /dev
  920.     ./MAKEDEV all
  921.  
  922.  
  923.  
  924. Administrivia:
  925. -------------
  926.  
  927. Registration?  What's that?
  928.  
  929. If you've got something to say, do so!  We'd like your input.
  930. There are various mailing lists available via the mailing list
  931. server at <majordomo@NetBSD.ORG>.  To get help on using the mailing
  932. list server, send mail to that address with an empty body, and it will
  933. reply with instructions.
  934.  
  935. There are various mailing lists set up to deal with comments and
  936. questions about this release.  Please send comments to:
  937.  
  938.     netbsd-comments@NetBSD.ORG
  939.  
  940. To report bugs, use the 'send-pr' command shipped with NetBSD,
  941. and fill in as much information about the problem as you can.  Good
  942. bug reports include lots of details.  Additionally, bug reports can
  943. be sent by mail to:
  944.  
  945.     netbsd-bugs@NetBSD.ORG
  946.  
  947. Use of 'send-pr' is encouraged, however, because bugs reported with it
  948. are entered into the NetBSD bugs database, and thus can't slip through
  949. the cracks.
  950.  
  951. There are also port-specific mailing lists, to discuss aspects of
  952. each port of NetBSD.  Use majordomo to find their addresses.  If
  953. you're interested in doing a serious amount of work on a specific
  954. port, you probably should contact the "owner" of that port (listed
  955. below).
  956.  
  957. If you'd like to help with this effort, and have an idea as to how
  958. you could be useful, send mail and/or subscribe to:
  959.  
  960.     netbsd-help@NetBSD.ORG
  961.  
  962. As a favor, please avoid mailing huge documents or files to these
  963. mailing lists.  Instead, put the material you would have sent up
  964. for FTP somewhere, then mail the appropriate list about it, or, if
  965. you'd rather not do that, mail the list saying you'll send the data
  966. to those who want it.
  967.  
  968.  
  969. Thanks go to:
  970. ------ -- --
  971.  
  972. Members and former members of UCB's Computer Systems Research Group,
  973. including (but not limited to):
  974.     Keith Bostic
  975.     Ralph Campbell
  976.     Mike Karels
  977.     Marshall Kirk McKusick
  978. for their ongoing work on BSD systems, support, and encouragement.
  979.  
  980. Also, our thanks go to:
  981.     Mike Hibler
  982.     Rick Macklem
  983.     Jan-Simon Pendry
  984.     Chris Torek
  985. for answering lots of questions, fixing bugs, and doing the various work
  986. they've done.
  987.  
  988. UC Berkeley's Experimental Computing Facility provided a home for
  989. sun-lamp in the past, people to look after it, and a sense of humor.
  990. Rob Robertson, too, has added his unique sense of humor to things, and
  991. for a long time provided the primary FTP site for NetBSD.
  992.  
  993. Without CVS, this project would be impossible to manage, so our hats
  994. go off to Brian Berliner, Jeff Polk, and the various other people
  995. who've had a hand in making CVS a useful tool.
  996.  
  997. Alistair G. Crooks <agc@westley.demon.co.uk> has been producing tar 
  998. file snapshot reports for NetBSD-current users, a very valuable 
  999. service.
  1000.  
  1001. Dave Burgess <burgess@cynjut.infonet.net> has been maintaining the
  1002. 386BSD/NetBSD/FreeBSD FAQ for quite some time, and deserves to be
  1003. recognized for it.
  1004.  
  1005. The following people (in alphabetical order) have made donations or
  1006. loans of hardware and/or money, to support NetBSD development, and
  1007. deserve credit for it:
  1008.     Jason Brazile
  1009.     Dave Burgess
  1010.     Charles Conn
  1011.     Canada Connect Corporation
  1012.     Brian Carlstrom
  1013.     Tom Coulter
  1014.     Charles D. Cranor
  1015.     Demon Internet, UK
  1016.     Greg Gingerich
  1017.     Michael L. Hitch
  1018.     Scott Kaplan
  1019.     Chris Legrow
  1020.     Herb Peyerl
  1021.     Mike Price
  1022.     Thor Lancelot Simon
  1023.     Bill Sommerfeld
  1024.     Paul Southworth
  1025.     Steve Wadlow
  1026.  
  1027. (If you're not on that list and should be, tell us!  We probably were
  1028. not able to get in touch with you, to verify that you wanted to be
  1029. listed.)
  1030.  
  1031. Finally, we thank all of the people who've put sweat and tears into
  1032. developing NetBSD since its inception in January, 1993.  (Obviously,
  1033. there are a lot more people who deserve thanks here.  If you're one of
  1034. them, and would like to mentioned, tell us!)
  1035.  
  1036.  
  1037. We are:
  1038. -- ---
  1039. (in alphabetical order)
  1040.  
  1041. The NetBSD core group:
  1042. J.T. Conklin        <jtc@NetBSD.ORG>
  1043. Charles Hannum        <mycroft@NetBSD.ORG>
  1044. Paul Kranenburg        <pk@NetBSD.ORG>
  1045.  
  1046. The port-masters (and their ports):
  1047. Allen Briggs        <briggs@mail.vt.edu>        (mac68k)
  1048. Chuck Cranor        <chuck@NetBSD.ORG>        (mvme68k)
  1049. Chris G. Demetriou    <cgd@NetBSD.ORG>        (alpha)
  1050. Charles Hannum        <mycroft@NetBSD.ORG>        (1)
  1051. Chris Hopps        <chopps@NetBSD.ORG>        (amiga)
  1052. Paul Kranenburg        <pk@NetBSD.ORG>            (sparc)
  1053. Ted Lemon        <mellon@NetBSD.ORG>        (pmax)
  1054. Anders Magnusson    <ragge@NetBSD.ORG>        (vax)
  1055. Phil Nelson        <phil@NetBSD.ORG>        (pc532)
  1056. Gordon Ross        <gwr@NetBSD.ORG>        (sun3)
  1057. Jason Thorpe        <thorpej@NetBSD.ORG>        (hp300)
  1058. Leo Weppelman        <leo@NetBSD.ORG>        (atari)
  1059.  
  1060. Supporting cast:
  1061. Steve Allen        <wormey@eskimo.com>
  1062. John Brezak        <brezak@NetBSD.ORG>
  1063. Dave Burgess        <burgess@cynjut.infonet.net>
  1064. Hubert Feyrer        <hubert.feyrer@rz.uni-regensburg.de>
  1065. Adam Glass        <glass@NetBSD.ORG>
  1066. Brad Grantham        <grantham@tenon.com>
  1067. Matthew Green        <mrg@eterna.com.au>
  1068. Michael L. Hitch    <osymh@gemini.oscs.montana.edu>
  1069. Lawrence Kesteloot    <kesteloo@cs.unc.edu>
  1070. John Kohl         <jtk@NetBSD.ORG>
  1071. Paul Mackerras         <paulus@NetBSD.ORG>
  1072. Neil J. McRae        <neil@domino.org>
  1073. Perry Metzger        <perry@NetBSD.ORG>
  1074. Herb Peyerl        <hpeyerl@beer.org>
  1075. Matthias Pfaller    <leo@marco.de>
  1076. Chris Provenzano    <proven@NetBSD.ORG>
  1077. Waldi Ravens        <waldi@moacs.indiv.nl.net>
  1078. Scott Reynolds        <scottr@edsi.org>
  1079. Thor Lancelot Simon    <tls@netbd.org>
  1080. Wolfgang Solfrank    <ws@tools.de>
  1081. Frank van der Linden    <fvdl@NetBSD.ORG>
  1082. Christos Zoulas     <christos@NetBSD.ORG>
  1083.  
  1084. Legal Mumbo-jumbo:
  1085. ----- ----- -----
  1086.  
  1087. The following notices are required to satisfy the license terms of
  1088. the software that we have mentioned in this document:
  1089.  
  1090.     This product includes software developed by the University of
  1091.     California, Berkeley and its contributors.
  1092.  
  1093.     This product includes software developed by the Computer
  1094.     Systems Engineering Group at Lawrence Berkeley Laboratory.
  1095.  
  1096.     This product includes software developed by Christopher G. Demetriou.
  1097.  
  1098.     This product includes software developed by Adam Glass.
  1099.  
  1100.     This product includes software developed by Christian E. Hopps.
  1101.  
  1102.     This product includes software developed by Paul Kranenburg.
  1103.  
  1104.     This product includes software developed by John Kohl.
  1105.  
  1106.     This product includes software developed by Terrence R. Lambert.
  1107.  
  1108.     This product includes software developed by Frank van der Linden.
  1109.  
  1110.     This product includes software developed by Philip A. Nelson.
  1111.  
  1112.     This product includes software developed by Jochen Pohl.
  1113.  
  1114.     This product includes software developed by Chris Provenzano.
  1115.  
  1116.     This product includes software developed by Theo de Raadt.
  1117.  
  1118.     This product includes software developed by the David Muir Sharnoff.
  1119.  
  1120.     This product includes software developed by SigmaSoft, Th. Lockert.
  1121.  
  1122.     This product includes software developed by Jason Thorpe.
  1123.  
  1124.     This product includes software developed by TooLs GmbH.
  1125.  
  1126.     This product includes software developed by Christos Zoulas.
  1127.  
  1128.  
  1129.  
  1130.       This product includes software developed by Christian E. Hopps.
  1131.  
  1132.       This product includes software developed by Gordon Ross
  1133.  
  1134.       This product includes software developed by Leo Weppelman.
  1135.  
  1136.       This product includes software developed by Markus Wild.
  1137.  
  1138.  
  1139.